home *** CD-ROM | disk | FTP | other *** search
/ Experimental BBS Explossion 3 / Experimental BBS Explossion III.iso / others / graf_m.zip / GRAF.DOC < prev    next >
Text File  |  1993-08-20  |  5KB  |  153 lines

  1. /*
  2. /////////////////////////////////////////////////////////////////////////////
  3. /                                                                           /
  4. /                      Graf, v1.0                                /
  5. /                                                                           /
  6. /                                                                           /
  7. /  Written by Jason Smart                                                   /
  8. /  Travelling Faire Software                                                /
  9. /                                                                           /
  10. /////////////////////////////////////////////////////////////////////////////
  11.  
  12.  
  13.  
  14. ABOUT
  15.  
  16.   Graf graphs functions of one or two independent variables.
  17.   It can graph in a variety of graphics modes, using
  18.   different line and fill colors, and different resolutions.
  19.   Graphs may also be easily rotated/resized/moved.
  20.  
  21.  
  22.  
  23. ENTERING EQUATIONS
  24.  
  25.   Graf accepts both capitalized and uncapitalized letters
  26.   in equations.
  27.  
  28.   Acceptable Variables include the following:
  29.     X     The x distance of the given point from the origin
  30.     Y     The y...
  31.     R     The radial distance from the origin, R = sqrt(sqr(x) + sqr(y))
  32.  
  33.   Acceptable functions include the following:
  34.     ABS   absolute value
  35.     SQR   square
  36.     SQRT  square root
  37.     COS   cosine
  38.     SIN   sine
  39.     TAN   tangent
  40.     ACOS  arc-cosine
  41.     ASIN  arc-sine
  42.     ATAN  arc-tangent
  43.     EXP   exponential, eg:  e^x
  44.     LN    natural(base e) log
  45.     LOG   base 10 log
  46.     INT   integer part of argument,    eg:  int(10.23) = 10
  47.     FRAC  fractional part of argument, eg: frac(10.23) = 0.23
  48.     COSH  hyperbolic cosine
  49.     SINH  hyperbolic sine
  50.     TANH  hyperbolic tangent
  51.  
  52.   Acceptable operations:
  53.     +     add,      eg:   5+x   3+2   r+tanh(5)  etc
  54.     -     subtract
  55.     *     multiply
  56.     /     divide
  57.     ^     raise to the power of,  eg:  y^2 is the same as sqr(y)
  58.  
  59.  
  60.   In Graf, three dimensional graphs use functions of the
  61.   form z = F(x,y,r), such as:
  62.  
  63.      z = sin(r)   z = x^3 + y^4     z = abs(y * r)
  64.  
  65.   Two dimensional graphs use functions of the form z = F(x),
  66.   such as:
  67.  
  68.      z = sin(x)     z = x^3 - 5       z = abs(x)     etc
  69.  
  70.   Any y variable appearing in a two dimensional equation
  71.   is set to zero, so for example z=y would be interpreted
  72.   as z=0 when graphing in two dimensions.  Also, since R
  73.   is defined as sqrt( sqr(x) + sqr(y) ), when graphing in
  74.   two dimensions it will reduce to sqrt( sqr(x) ), since
  75.   y is zero.  Therefore, r = abs(x) in two dimensional
  76.   graphs, which makes sense since r is the (positive) radial
  77.   distance from the origin.
  78.  
  79.  
  80. GRAPHING EQUATIONS
  81.  
  82.   Press '?' anytime while graphing for graph help.
  83.  
  84.   Anytime while graphing, press:
  85.      4,6     Rotate 3D object around body z axis.
  86.      2,8     Rotate 3D object around fixed x axis
  87.      1,7       or around fixed z axis.
  88.      h       Draw in High Resolution - very slow, but worth it.
  89.      imjl    Move entire object up/down/left/right.
  90.      CTRL-imjl  Move entire object up/down/left/right faster.
  91.      *,/     Change z scale.
  92.      +,-     Change x & y scale.  In 2D changes x scale only.
  93.      g       Change graphics mode: Lines Only, Fill Only, or Lines & Fill.
  94.      z       Call SETUP.
  95.      a       Toggle drawing axis.
  96.      b       Toggle drawing border around object. Not used for radial graphs
  97.      d       Toggle drawing graph itself.
  98.      s       Toggle drawing equation string and labelling axis.
  99.      c       Change fill color.
  100.      p       Change line color.
  101.      q,ESC   Quit to main menu.
  102.  
  103.  
  104.  
  105.                More on changing graphics mode:
  106.  
  107.   The three modes in three and two dimensions are:
  108.  
  109.   3D: Line Only:   Draws only the lines connecting each z=F(x,y) point.
  110.       Fill Only:   Fills between the z=F(x,y), where the brightness
  111.            of the fill color represents the general height of
  112.            the graph at those points.
  113.       Line & Fill: Does both.
  114.   2D: Point Only:  Draws only individual points, representing z=F(x).
  115.       Line Only:   Draws lines between the individual points.
  116.       Point & Line:Does both.
  117.  
  118.  
  119.  
  120.  
  121. OTHER NOTES
  122.  
  123.   Note that radial graphs are useful only at higher
  124.   resolutions - at lower resolutions the graphs will
  125.   appear choppy, broken.
  126.  
  127.   Sometimes, when switching between 2D and 3D graphs,
  128.   or when changing the equation, the graph will appear
  129.   extremely compacted or expanded.  This is due to an
  130.   extremely large/small XY or Z scale.  When these
  131.   problems occur, repeatedly pressing '/' or '*'
  132.   (reduce/expand Z scale) or '-+' (reduce/expand XY
  133.   scale) should fix the problem.
  134.  
  135.  
  136.  
  137.  
  138. QUESTION/COMMENTS:
  139.  
  140.   EMail:    Jules33           America Online
  141.         Jules33@aol.com   Internet
  142.  
  143.   or write: Jason Smart
  144.         1158 Panoramic Dr.
  145.         Martinez, CA 94553
  146.  
  147.  
  148.   This program may be distributed freely, as long as this
  149.   documentation file remains with it.
  150.  
  151.  
  152.  
  153.